home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_4 / startupselector1.2 / startupselector-uk.doc < prev    next >
Text File  |  1982-11-13  |  12KB  |  345 lines
  1.                   --------------------------------------
  2.                   * Moonchild Prod. proudly presents : *
  3.                   --------------------------------------
  4.  
  5.                           /-=-=-=-=-=-=-=-=-=-=-\
  6.                          < STARTUPSELECTOR   1.2 >
  7.                           \-=-=-=-=-=-=-=-=-=-=-/
  8.  
  9.                               1. Copyrights
  10.  
  11.                               2. Introduction
  12.  
  13.                               3. Requierements
  14.  
  15.                               4. Installation 
  16.  
  17.                               5. Startup
  18.  
  19.                               6. Greets
  20.  
  21.                               7. The author
  22.  
  23.                               8. The futur
  24.  
  25.                               9. History
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38. 1. Copyrights :
  39. ***************
  40.  
  41.  The program and its source in this archive are both Copyright (c) 1996
  42. OLIVERES 'Moonchild' Jean-Marc.
  43.  
  44.  You can freely modify the program's source. The only thing I asked you is to
  45. send me a version with your modifications and don't forget to credit me.
  46.  
  47.  Authorization is granted to distribute copies of this manual if the
  48. copyright notice and this authorization notice are in all the copies.
  49.  
  50.  No warranty are done for a 100% perfect program describe in this file. You
  51. use your equipment at your own risks. The author can't be made responsible
  52. for any damage caused by the use of this program.
  53.  
  54.  You can distribute this archive freely but it is always Copyright OLIVERES
  55. Jean-Marc. You can freely copy it as long as you don't ask more than the cost
  56. of a single copy.
  57.  
  58.  Authorization is granted to include this archive in the DP collections.
  59.  
  60.  If you want to distribute this archive, you must use archives from the
  61. original distribution.
  62.  
  63.  
  64. 2. Introduction :
  65. *****************
  66.  
  67.  Welcome to the fabulous world of startup-sequence selectors.
  68.  
  69.  With this little program, you'll have the possibility to execute differents
  70. startup files, according to your wishes.
  71.  
  72.  You just have to write as many startup files as you want to begin your Amiga
  73. session in the way you like because you made it.
  74.  
  75.  The program will show you the list of all your files and you'll just have to
  76. click on the name you have choosen to execute this startup-sequence file.
  77.  
  78.  You can also deactivate the WBStartup directory and the User-Startup file to
  79. gain some space memory.
  80.  
  81.  You'll have the possibility to open a Shell.
  82.  
  83.  Starting from version 1.1 :
  84.  
  85.  If you have WBStartup+ installed then a button will appear at the bottom of
  86. the window and you'll have the possibility to call its Preferences program.
  87.  
  88.  Now you can save your last choosen file and your differents choices.
  89.  
  90.  I hope it will be as usefull as it is for me and some of my friends.
  91.  
  92.  This program has been written in the E language, and it's my first try of
  93. programming on AMIGA. I hope you'll excuse some mistakes I could make in the
  94. source structure.
  95.  
  96.  The source is in the source directory.
  97.  
  98.  Note: 
  99.  -----
  100.  
  101.        StartupSelector is Giftware. Send me what you want if you think this
  102. program is usefull for you (a postcard of your country, a disk full of mangas,
  103. a chocolate box, an PPC Amiga ...). There's no reason to make it  Shareware.
  104. I spent a lot of time on it but no money was used.
  105.        The goal is to know if people use this proggy because as I don't have an
  106. E-mail it is very hard for me to know this.
  107.        Thanks for all those who will send me something.
  108.  
  109.  
  110. 3. Requierements :
  111. ******************
  112.  
  113.  To run this program you need :
  114.  
  115.   - An AMIGA :-)
  116.  
  117.   - The Reqtools.library Copyright © Nico François (optional)
  118.  
  119.   - The LoadWB command in the C: directory
  120.  
  121.   - The WBStartup+ program Copyright © 1996 John Hughes (optional)
  122.  
  123.  The program was tested and written with an Amiga 1200 with an accelerator card
  124. Microbotics 68030/50Mhz an a 520 Mo HD and 6 MO of RAM.
  125.  
  126.  You need an Amiga with the release 2.0+ of the Workbench.
  127.  
  128.  
  129. 4. Installation :
  130. *****************
  131.  
  132.  Simply use the Installer script if there's one. If not, be patient until it
  133. is released.
  134.  
  135.  To install it, you just have to copy it where you want on your HD. The more
  136. simple is to copy it in the C: directory.
  137.  
  138.  Next, make a dir called 'Start' in S: because you'll put your scripts in it.
  139. You may change this if you want (see the 'Startup' section).
  140.  
  141.  Then edit a small Startup-Sequence with the 'Setpatch' command and the path
  142. to where you've put 'StartupSelector' without the 'Run' command. This file
  143. become the one executed when you switch on your Amiga.
  144.  
  145.  Your original Startup-Sequence file MUST be copied in the directory where
  146. you'll put all your scripts (default is 'S:Start/'). You must delete or put
  147. into comment (';') the line with the 'Setpatch' command.
  148.  
  149.  NOTE : make a secure copy of your original Startup-Sequence file and keep it
  150.         somewhere (ie Startup-Sequence.org).
  151.  
  152.  Simple isn't it ? :-) no ?... it is !!!
  153.  
  154.  
  155. 5. Startup :
  156. ************
  157.  
  158.  My Startup-Sequence file looks like this:
  159.  
  160.                           Assign c: hd0:Cmds ADD
  161.                              C:Setpatch QUIET         /* IMPORTANT */
  162.                                autoxa > nil:
  163.                               startupselector         /* IMPORTANT */
  164.  
  165.  Now you have to know that StartupSelector can have an optionnal argument.
  166. This one is the path to the directory where you put your scripts.
  167.  
  168.  But if you run it without argument, it will automatically search your files in
  169. the 'S:Start' directory. You MUST create it if it please you.
  170.  
  171.  i.e: StartupSelector HD4:startup --> It'll search files in this directory.
  172.       StartupSelector --> It'll search files in the 'S:Start' directory.
  173.  
  174.  More, you can deactivate the WBStartup directory and the User-Startup file.
  175. The program just rename them as 'WBStartupOld' and as 'User-StartupOld'.
  176.  
  177.  You don't have to worry about the directory because the first thing that
  178. StartupSelector do at the begining is to rename the directory and the file in
  179. the right way.
  180.  
  181.  To call it, simply press the left mouse button at the start of your Amiga
  182. session until the window appears. If not, It'll automatically execute the
  183. Startup-Sequence file. So don't forget to put it in your directory :-).
  184.  
  185.  At the window opening, it will let you the choice between all your files with
  186. the Startup-Sequence file.
  187.  
  188.  With the version 1.1 you can save your choices and the last startup file you
  189. have selected. A file called 'startupselector_log' will be written in your
  190. S: directory. You can delete it if you want but if StartupSelector can't find
  191. it, it'll create it automatically for you and it'll start with this settings.
  192. In other words, all settings will be off and the program will execute the file
  193. called 'Startup-Sequence'.
  194.  
  195.  The default settings are : N = User-Startup activated (else Y)
  196.                             N = WBStartup activated (else Y)
  197.                             N = 'Remember choice' not checked (else Y)
  198.                             Startup-Sequence = file to execute
  199.  
  200.  You can edit it by hand but don't remove the ASCII code 0 between each
  201. setting or you'll have some problems.
  202.  
  203.  If you have the WBStartup+ program installed a button will appear at the
  204. bottom of the window. If you click it you will call the Preferences program of
  205. WBStartup+. If it is not installed nothing will appear.
  206. StartupSelector will search in the 'SYS:prefs' directory to find the program
  207. called 'WBStartup+Prefs'.
  208.  
  209.  More, the name of the last saved script will be written in the middle of the
  210. free space at the right of the window to allow you to remember it if you
  211. haven't use your Amiga for a long time or if someone else use it and save its
  212. own settings.
  213.  
  214.  In the menu, you'll have the possibility to open a SHELL or to quit the
  215. program.
  216.  
  217.  The closing window button lets you start with the last saved script with or
  218.  without modifying the settings.
  219.  
  220.  
  221. 6. Greets :
  222. ***********
  223.  
  224.  First I would like to thank Wouter Van Oortmerssen for his wonderful E
  225. language.
  226.  
  227.  I would like to thank Jason R. Hulance for his "Beginer.Guide" wich is of
  228. great help for new developers.
  229.  
  230.  Thanks to John Hughes for the WBStartup+ program. I used your program
  231. because some people tell me to include it in my program. Sorry not to have
  232. demand you for an authorization. I hope you don't mind :-).
  233.  
  234.  Hello to Raphaël Guénot for his help in the writing and the optimization of
  235. some procedures.
  236.  
  237.  Hello to Philippe 'Elwood' Ferrucci for his help during the finalisation of
  238. the 1.0 and 1.05 versions.
  239.  
  240.  Thanks a lot to Eric Trinh for sending me a gift.
  241.  
  242.  Last but not least, hellos goes to : 
  243.  
  244.    Alamelama Dominique    (merci pour la réparation de mon Amiga)
  245.    Delantes 'HCL' Mathias (tes logiciels sont rigolos)
  246.    Daniel de JANAL LYON   (l'idée de ce logiciel était bonne)
  247.    Saillour Pierre        (range ton disque dur vieux !)
  248.    Mearini Renaud         (tu vas faire un malheur avec "Ben" et "Speed")
  249.    Arnaud Yvan            (vive le CD-ROM)
  250.  
  251.  And of course, hello at the Amiga scene.
  252.  
  253.  WE ARE BACK FOR THE FUTUR !
  254.  
  255.  
  256. 7. The author :
  257. ***************
  258.  
  259.  You can join me for comments or ideas at the following:
  260.  
  261.      OLIVERES Jean-Marc
  262.      12, Rue Charles Porcher
  263.      69009 LYON
  264.      FRANCE
  265.  
  266.  You con contact me at this E-Mail address :
  267.  
  268.      elwood@neptune.fr     with Subject: Moon
  269.  
  270.  Excuse me for my bad english but I'm French.
  271.  
  272.  
  273. 8. The futur :
  274. **************
  275.  
  276.  Here is some ideas I have:
  277.  
  278.   - make a localisation (doing that).
  279.  
  280.   - make an Installer script (doing that).
  281.  
  282.   - Make the program to be a script executor if launched from the Workbench.
  283.  
  284.  
  285. 9. History :
  286. ************
  287.  
  288. Internals versions: 06.20.96 - 07.08.96
  289. -------------------
  290.  
  291.  Version 0.1 : - just a simple window at the start of the Amiga session with
  292.                  the list of the files to execute.
  293.  
  294.  Version 1.0 : - the selected file is executed.
  295.                - programm run at each Amiga session.
  296.                - it can't be included in the Startup-Sequence.
  297.  
  298.  Version 1.01 : - called by the left mouse button.
  299.                 - can be put in the Startup-Sequence.
  300.                 - but continue with it at the end of the script.
  301.  
  302.  Version 1.02 :  - close the Startup-Sequence (bug).
  303.                  - execute only the choosen script.
  304.  
  305.  Version 1.03 :  - bug in the closing of the Startup-Sequence not fixed.
  306.                  - possibility to deactivate the WBStartup directory.
  307.                  - window centered on the opening screen.
  308.  
  309. Externals releases: 07.16.96
  310. -------------------
  311.  
  312.  Version 1.04 :  - added argument for the path of the scripts.
  313.                  - program launched from a small Startup-Séquence.
  314.                  - execute the Startup-Sequence file if no LMB press.
  315.                  - added menu.
  316.                  - GUI looks better.
  317.                  - some optimisations.
  318.                  - first release.
  319.                  - added alphabetical order.
  320.                  - possibility to deactivate the User-Startup file.
  321.                  - can open a CLI.
  322.                  - fixed a bug with the possibility to deactivate the WBStartup
  323.                    directory because it was running just in one way.
  324.  
  325.  Version 1.05 (09.07.96) :  - replace buttons by a listview.
  326.                             - no more file number limitation.
  327.                             - better errors handler.
  328.                             - removed an Enforcer hit in the menu.
  329.  
  330.  Version 1.1 (09.24.96) :  - last script choosen saved.
  331.                            - choices are saved too.
  332.                            - some optimisations.
  333.                            - run with or whithout the Reqtools.library.
  334.                            - show the last saved script.
  335.                            - detects and have the possibility to run the
  336.                              WBStartup+ preferences if installed.
  337.                            - auto-creation of the xx_log file the first time
  338.                              the program is ran.
  339.                            - rewritten this doc to be clearer in the
  340.                              installation and startup sections.
  341.  
  342.  Version 1.2 (02.01.97) :  - double-click to choose your script.
  343.                            - removed a bug when a 'space' was in your script's
  344.                              name, because it won't be launched.
  345.